home *** CD-ROM | disk | FTP | other *** search
/ Freelog 58 / Freelog058.iso / Graphisme / Gimp / gimp-gap-2.0.0-setup-1 / gimp-gap-2.0.0-setup.exe / {app} / gap-readme.txt
Text File  |  2004-04-26  |  74KB  |  1,874 lines
  1. Project gap "GIMP Animation Package" version 2.0
  2.  
  3. --------------------------------------------------------------------
  4. Introduction
  5. --------------------------------------------------------------------
  6.  
  7. The GIMP is a great program for creating and manipulating pixelbased
  8. images of many types. The plug-in concept and the procedural database
  9. allows programmers to extend the GIMP's functions in many ways.
  10.  
  11. In the GIMP there are some plug-in's supporting animation features,
  12. based on layers where each layer of the image is considered as one
  13. frame of the animation.  GIMP-GAP is a collection of plug-ins that
  14. extends the GIMP's animation capabilities by supporting the creation
  15. of more complex animations.
  16.  
  17. Idea:
  18.     With the help of the GIMP-GAP plug-in collection
  19.     GIMP can operate on a series of images as if they were
  20.     a single one.
  21.     Each frame of an animation can have multiple layers.
  22.     The user can step from frame to frame by pressing an accelerator
  23.     key or can do image manipulations that are propagated automatically
  24.     to a selected range of frames.
  25.  
  26.     Layeranimated images can be combined with frames (multiple images)
  27.     as you can see in the "Move Path" plug-in
  28.         or converted to frames and vice-versa. 
  29.  
  30.     
  31. Concept:
  32.     An animation consists of a series of images of the same size & type
  33.     (frames).
  34.     The concept of GIMP-GAP is to store each frame seperate on
  35.         disk, using a filename convention that includes the frame number
  36.         and extension.
  37.  
  38.     Example: film_000001.xcf, 
  39.              film_000002.xcf
  40.              ..
  41.              film_000012.xcf
  42.     
  43.     GIMP's xcf fileformat should be used to store the frames,
  44.     so that each frame can have more layers.
  45.  
  46.     Sound is not supported in this concept, but will be handled
  47.     as sperate audiofiles at encoding time or in the playback module.
  48.     The playback framerate and other common information about the
  49.     animation are stored in an extra videoinfo textfile
  50.              film_vin.gap
  51.     
  52.     This requires a lot of diskspace but offers much more flexibility
  53.     while working on the animation.
  54.  
  55.     To save diskspace you may optional use gziped xcf frames
  56.     (takes extra time to un/compress) by using the extension .xcfgz
  57.     (gzip has to be installed on your system to do that)
  58.     If you can accept lossy compression you may also use 
  59.     the xjt fileformat to store your frames on jpeg based compression.
  60.     (the curent implementation of the xjt fileformat
  61.      is resticted to UNIX operating systems)
  62.     
  63.     The final product can be encoded as videofile
  64.     or converted to one multilayerd image
  65.     that can be saved as animated-gif
  66.     (or, in the future in other animation formats 
  67.     when other load/save modules were added to the GIMP)
  68.  
  69.     GIMP-GAP provides automated fileformat conversions for
  70.     the frames of an animation. 
  71.     This conversions offer a way to use external
  72.     video encoder programs.
  73.     All GIMP-supported imagefileformats may be used.
  74.     
  75.     On UNIX Platforms GIMP-GAP provides frontend dialog interfaces for
  76.     software MPEG video encoder programs.
  77.     (mpeg_encode and mpeg2encode)
  78.     
  79.     On UNIX platforms GIMP-GAP also provides an XANIM frontend to
  80.     load frames from multimedia fileformats (avi, quicktime, ....)
  81.     based on the XANIM multimedia player. please note that XANIM is
  82.     old and unmaintained software.
  83.     
  84.     
  85. Onionskin Layers
  86.         GIMP-GAP does support onionskin layers, this features are described
  87.         in the file README_onion.txt    
  88.     
  89.     
  90.     
  91.  
  92. --------------------------------------------------------------------
  93. Installation
  94. --------------------------------------------------------------------
  95.  
  96. This version of GIMP-GAP is a seperated Package since GIMP-1.3.x
  97. and does not compile/run with GIMP-1.2.x or older GIMP versions.
  98.  
  99.   ./autogen.sh   # includes the ./configure call
  100.   make
  101.   make install
  102.  
  103.     
  104.   Notes:
  105.    
  106.    - GIMP 1.1.4 upto GIMP-1.2.x have included older versions of GIMP-GAP
  107.      as standard plug-in (named gap) with no need of extra installation.
  108.  
  109.  
  110.    - GIMP-GAP provides frontend dialogs for:
  111.       - mpeg_encode (V1.5R2)
  112.       - mpeg2encode (V1.2)
  113.       - xanim 2.80.1 exporting edition (with the extensions from loki
  114.         entertainment)
  115.  
  116.      The frontends and the external programs need UNIX environment to run.
  117.       
  118.      If you like to use that stuff, you should install
  119.        mpeg_encode and mpeg_play
  120.        mpeg2encode and mpeg2decode
  121.        xanim 2.80.1 (loki)
  122.      on your system.
  123.  
  124.    - The GIMP-GAP playback module provides audiosupport for audiofiles
  125.      in RIFF WAV format. The audiosupport is based on wavplay (tested with
  126.      version 1.4).
  127.      
  128.      If you want to have audiosupport you must install wavplay
  129.      and configure and compile gimp-gap without the
  130.      configure option --disable-audiosupport
  131.      
  132.      As far as i know, wavplay is available only for LINUX, but i may
  133.      be wrong...
  134.      
  135.      The GIMP-GAP playback module further provides a button for converting
  136.      other audiofile formats to RIFF WAV.
  137.      If you want to use that feature the external following programs
  138.      must be installed:
  139.       - sox
  140.       - lame
  141.      
  142.    - There is no need to install all those external programs to
  143.      compile GIMP-GAP.
  144.  
  145. --------------------------------------------------------------------
  146. Supported Videoformats
  147. --------------------------------------------------------------------
  148.  
  149. Read(decode):
  150.   Any multimedia fileformat, XANIM can read
  151.   (AVI, Quicktime, and a lot more, see xanim docu for more information)
  152.   
  153. Write (encode)
  154.   MPEG1/2 based on the external encoders mpeg_encode and mpeg2encode
  155.   
  156.  
  157. The GIMP_VIDEO_ENCODER project is an additional Package for GIMP-GAP
  158. that implements Video Encoding. It is still under development.
  159. An unstable prototype of the GIMP_VIDEO_ENCODER is available for GIMP-1.2.x.
  160.  
  161.  
  162. --------------------------------------------------------------------
  163. How to use
  164. --------------------------------------------------------------------
  165.  
  166.  
  167. - Creating multiple frames (video frames)
  168. - ---------------------------------------
  169.  
  170.       - from an existing single image
  171.            Save your image as XCF file.  (<Image>/File/Save as)
  172.            use a name that ends up in _000001.xcf (or _000001.xcfgz)
  173.            
  174.            Then duplicate your image (<Image>/Video/Duplicate)
  175.            You'll be asked how much copies you need.
  176.            (Note: all copies are stored on disk immediate
  177.                   without explicite save)
  178.  
  179.        - from an existing layeranimated multilayer image
  180.            use
  181.                <Image>/Video/Split Img to frames
  182.                
  183.            This will create frames, a series of images on disk,
  184.            with a name that ends up in _000001.xcf).
  185.            Optional you may use other extensions. (.xcfgz, .jpg ...)
  186.  
  187.            WARNING: The extension defines the fileformat
  188.                     of the frames. Most of the other formats
  189.                     (than GIMP's .xcf format) can not save
  190.                     multilayer frames, or frames with alpha channels.
  191.           
  192.       - from outside the GIMP
  193.            You may rename and copy existing XCF images
  194.            according to the frame naming conventions.
  195.            <img>_000001.xcf
  196.            <img>_000002.xcf
  197.            ...
  198.            Then load (only one of them) into the GIMP.
  199.            
  200. - Navigation (Goto)
  201. - ------------------
  202.       It is recommanded to define some accelerator keys for quick
  203.       walk through the frames.
  204.       Here are my settings (excerpt from my $HOME/.gimp/menurc )
  205.  
  206.       (menu-path "<Image>/Video/Goto/First Frame" "<control><alt>1")
  207.       (menu-path "<Image>/Video/Goto/Prev Frame" "<alt>1")
  208.       (menu-path "<Image>/Video/Goto/Next Frame" "<alt>2")
  209.       (menu-path "<Image>/Video/Goto/Any Frame" "<alt>3")
  210.       (menu-path "<Image>/Video/Goto/Last Frame" "<control><alt>2")
  211.       
  212.       Alternatives:
  213.       - You may open the GIMP-GAP videoplayer
  214.         (menu-path: <Image>/Video/Playback...)
  215.         and use the player for visual positioning 
  216.         (use the FrameNr Button or the GO-Button array for that task)
  217.       
  218.       - You may open the GIMP-GAP video navigator dialog
  219.         (menu-path: <Image>/Video/VCR Navigator)
  220.       
  221.  
  222. - GAP VCR Navigator:
  223. - ------------------
  224.  
  225.    Start from menu:
  226.      <Image>/Video/VCR Navigator
  227.  
  228.    The VCR Navigator dialog shows a thumbnail view, frame_number and
  229.    time (mm:ss:msec) of the frames in a scrollable listbox.
  230.    framerate:
  231.      You can set the global framerate for all frames here.
  232.   
  233.      (Note: changing the framerate in the VCR Naviagtor
  234.             dialog window does not change the number of frames.
  235.             Therefore the motion does speed up or slow down
  236.             at playback. If you want to keep your motion
  237.             speed constant at increased framerate use the
  238.             "Frames Density" tool to create the requested additional
  239.             frames)
  240.             
  241.  
  242.    timezoom:
  243.      with timezoom you tell the VCR Navigator dialog window
  244.      to display every n-th frame only, to get an overview
  245.      on larger videos.
  246.  
  247.      Framerate and timezoom values are stored in
  248.       a gap vide info file named:
  249.       <framebasename>_vin.gap
  250.  
  251.    Double click with left mousebutton on a frame in the listbox
  252.    performs a goto operation, which loads the clicked
  253.    frame as current frame.
  254.    
  255.    Single click with left mousebutton 
  256.       selecets one frame (deselecting all others)
  257.    Ctrl  click with left mousebutton
  258.       selecets one frame (additional to the current selection)
  259.    Shift click with left mousebutton
  260.       selects a range of frames.
  261.    
  262.    Click with right mousebutton
  263.      brings up a pop-up menu
  264.  
  265.    Pop-up menu
  266.       copy, 
  267.       cut
  268.       paste before
  269.       paste after
  270.       paste replace
  271.       clear pastebuffer
  272.       select all
  273.       select none
  274.       
  275.       cut and copy
  276.          is sensitive if any frame is selected,
  277.       paste and clear pastebuffer
  278.          is sensitive if video paste buffer contains
  279.      at least one frame.
  280.      
  281.       This menu enables you to cut, copy and paste the selected
  282.       frames even between different videos.
  283.       Size and type of the handled frames are converted at pasting
  284.       if needed.
  285.       The palette of the current frame is used for the
  286.       pasted frames when the destination type is INDEXED.
  287.  
  288.       There are 3 types of paste:
  289.         before:
  290.        Insert frames before the current frame.
  291.        Use this mode if you want to insert frames
  292.        before the first frame.
  293.     after:
  294.        Insert frames after the current frame.
  295.        Use this mode if you want to insert frames
  296.        after the last frame.
  297.     replace:
  298.        Replace frames beginning at the current frame
  299.        with the frames from the video paste buffer,
  300.        and does overwrite existing frames.
  301.  
  302.       If there are selected frames in the VCR Navigator
  303.       dialog window, the current frame is set to
  304.       the first selected frame and the paste opration
  305.       is releted to the first selected frame
  306.      
  307.       The paste buffer is located in the filesystem
  308.       and can be configured in the gimprc file:
  309.        
  310.        (video-paste-dir "/home/hof/gap_video_paste_dir")
  311.        (video-paste-basename "gap_video_paste_")
  312.      
  313.     The duplicate button in the VCR Navigator dialog
  314.     duplicates the selected frames immediate into
  315.     the current video, without writing to the
  316.     video paste buffer.
  317.     
  318.     The delete button in the VCR Navigator dialog
  319.     deletes the selected frames without writing to the
  320.     video paste buffer.
  321.     
  322.     IMPORTANT NOTE: 
  323.        There is no undo for GIMP-GAP operations,
  324.        and the deleted frames can not be restored.
  325.     
  326.  
  327. - Playback
  328. - --------
  329.     Start the playback plug-in from the menu:
  330.  
  331.     <Image>/Video/Playback...
  332.  
  333.     This player does playback of your video frames.
  334.     Along with the video you can also do playback of an audiofile.
  335.     The player is a tool that should help to give a motionpreview
  336.     and allows visible positioning for the animation designer.
  337.     
  338.  
  339.     There is NO support for playback of videoformats (like MPEG, AVI, ....)
  340.      
  341.     Some notes on the audiosupport:
  342.     - The audio playback checks for the existence of the wavplay audioserver executable
  343.       file in your gimprc file 
  344.         (wavplaypath  "/usr/X11R6/bin/wavplay")
  345.       then checks the environment variable
  346.          WAVPLAYPATH=/usr/X11R6/bin/wavplay
  347.       and finally searches an executable named wavplay in all directories
  348.       defined by your PATH environment variable.
  349.  
  350.     - Audiosupport can be completely turned off at compiletime.
  351.       If Audiosupport was enabled at compiletime, The playback dialog window
  352.       contains a notebook widget tab named "Audio Options"
  353.     
  354.     - Audio is always turned off, while frames are played backwards.
  355.     - The audioplayback samplerate tries to follow the videospeed.
  356.       If videoframes are played at the original speed, audio is played
  357.       at the normal samplerate. 
  358.       If video speed is too fast audio may not follow synchron.
  359.     - If the "Excact Timing" checkbox is off (unchecked) video and audio
  360.       will not play synchron !
  361.  
  362.     
  363.     
  364.     Video Options:
  365.     
  366.     - Play (>) button
  367.         Start the playback,
  368.         or switch to forward play if already playing reversed. 
  369.         
  370.     - PlayReverse (<) button
  371.         Start the reversed playback,
  372.         or switch to reversed play if already playing forward. 
  373.     
  374.     - Pause button (||)
  375.         Stop playback,
  376.         or go to fist frame of the selcted frame range if not playing.
  377.         Go to the end of selected frame range if right mousebutton was used.
  378.         or go to the active framenr if the midle mouse button was used.
  379.         (the active framenumber is the one that is currently
  380.         loaded in the GIMP image window from where you invoked the player)
  381.  
  382.     - The GO button array
  383.          the 50 blank buttons above the preview build up the GO butto narray,
  384.          This tool is for positioning and manual speedcontrol.
  385.          
  386.          Move the mousepointer over those buttons to display
  387.          frames in sequence as fast as you move the mouse.
  388.          Moving right is forward, left is backward.
  389.  
  390.          Tip: 
  391.            The positioning is done relative to the point where the
  392.            mouse entered the GO button array.
  393.            If you reached the leftmost GO button at framenr 50
  394.            and want to go more backwards (to framenr 35), 
  395.            just move the Mouse outside the GO button array (up or down)
  396.            and then enter again from the right side,
  397.            and continue moving to the left, but now
  398.            keeping the mouse inside the GO button array
  399.            until the desired frame (Nr. 35) is reached.
  400.          
  401.          
  402.          WARNING: This feature requires that the "Use Thumbnails"
  403.           checkbutton is turned ON, and can do useful work
  404.           only if your frames have thumbnail files.
  405.           
  406.           Even fast machines may have problems to deliver 
  407.           full sized multilayer frames in time.
  408.           (depending on size of the frames, number of layers
  409.            and IO performance of your hardware)
  410.   
  411.    - From and To spinbuttons:
  412.         Here you can select a framerange by entering
  413.         the begin and end framenumber.
  414.     
  415.  
  416.    - FrameNr button
  417.         With a mouseclick on the "FrameNr" button
  418.         You can load the frame (the number that is currently on the players display)
  419.         into the active image window where you can paint on it.
  420.         
  421.         Alternative you can also click on one of the GO buttons,
  422.         or on the players display to reload the active image with
  423.         the desired frame.
  424.  
  425.    - FrameNr spinbutton
  426.         This widget displays the current framenr of the player.
  427.         you can enter any availale framenumber.   
  428.  
  429.         The timepos: mm:ss:sec displays the current position
  430.         in Minutes:Secons:Microseconds
  431.         
  432.         (The time calculation is always based on the original speed.
  433.          This is the framerate of your animation as found in the _vin.gap file.
  434.          You can change the framerate in the VCR Navigator window)
  435.  
  436.     - Speed button
  437.          Reset Speed to the original (the framerate of your Animation)
  438.          (a 2.nd click goes back to the previous enters Speed)
  439.  
  440.     - Speed spinbutton
  441.          Here you can enter the desired playback speed.
  442.          The available range is 1 upto 250 frames/sec.
  443.          
  444.          Please note that 250 frames/sec may not be reached on
  445.          most machines. 
  446.          If the exact_timing checkbutton is ON,
  447.          the 250.th frame will be reached in time (after 1 second),
  448.          but if your machine can handle only 25 frames in one second
  449.          you will see just frame 10, 20, 30, 40, .... , 230, 240, 250
  450.  
  451.     - Size button
  452.          Set the standard thumbail size 
  453.          There are two standard sizes 
  454.             "normal" 128 Pixels
  455.             "large"  256 Pixels
  456.          this button toggles between both sizes.
  457.          If you hold the SHIFT key wihle clicking the size button,
  458.          the preview is scaled to 1:1 original framesize.
  459.         
  460.     
  461.     - Loop checkbutton:
  462.          Plays in loop if ON, otherwise play once and then stop.
  463.  
  464.     - Selection only
  465.          Play only frames within the selected range.
  466.          if not checked (OFF) play all frames.
  467.          
  468.     - PingPong
  469.          Play alternating backward/forward
  470.     
  471.     - Exact Timing
  472.          if this checkbutton is ON (the checked state)
  473.          the player tries to keep the frametiming
  474.          as exact as possible. if your machine
  475.          is not fast enough one or more frames
  476.          of the sequence are not displayed (dropped)
  477.          and the next frame is diplayed in time.
  478.  
  479.          if this checkbutton is OFF
  480.          all frames are displayed.
  481.          this leads to more and more growing delay
  482.          depending on the the power of your machine.
  483.  
  484.          
  485.     - Use Thumbnails
  486.          use thumbnail files if available.
  487.          Both the PNG based open thumbnails standard
  488.          and the older .xvpics based thumbnail files
  489.          are supported.
  490.          
  491.          Thumbnail based playback has reduced quality.
  492.          If there are just .xvpics thumbnail files
  493.          the quality is very miserable.
  494.          
  495.          The full original frame images are read in case when
  496.          no thumbnail file is available,
  497.          (Note:
  498.            It also does create the thumbnail file in such a case,
  499.            but this is only done, if the preferences setting
  500.            permits normal (or large) thumbnail files)
  501.          )
  502.          
  503.          
  504.          If the "Use Thumbnails" checkbutton is switched OFF
  505.          the player always reads the full original sized frame images 
  506.  
  507.          Playback with full frame image read mode
  508.          is very slow, even on fast machines,
  509.          but gives the original quality.
  510.          
  511.     Audio Options: 
  512.      NOTE: The audio options are not existent
  513.            when compiled with --disable-audiosupport.
  514.     
  515.     - Audiofile:
  516.         Here you can specify the audiofile. (you may also use the "FileBrowser" button)
  517.  
  518.     - Volume:
  519.         *** Volume control is not implemented yet ***
  520.     The "Enable" checkbox can turn ON/OFF audio playback.
  521.     
  522.     - Offset
  523.         Here you can shift the audiostart against the video startframe.
  524.     An offset value 0 will start auduio at the first frame.
  525.     Negative offsets will start audio with a delay of n frames.
  526.     Positive offsets will skip the beginning of the audiofile.
  527.     The skipped duration is equal to the time it takes to play n frames
  528.     at original framerate.
  529.     
  530.     The "Offset" label shows the audio shift in unit Minutes:Secs:Millisecs.
  531.     The "Audiotime" label shows the total playing time of the audiofile
  532.     (without taking care of the offset shifts)
  533.     
  534.     The "Audioframes" label shows the total playing time of the audiofile
  535.     in unit frames where frames are played at the original 
  536.     framerate of the video frames.
  537.     
  538.     The ohter labels show informations about the audiofile.
  539.     - Nuber of Samples
  540.     - Samplerate  (in Samples / Sec)
  541.     - Channles    (usual 2 for stereo)
  542.     - Bits/Sample
  543.  
  544.     If no valid audiofile was specified, all values are filled with 0.
  545.      
  546.      - Copy As Wavfile
  547.         This button provides conversion of audiofile formats to RIFF WAV.
  548.     It opens a subdialog where the name of the wavfile can be entered
  549.     and where you can optional specify a new samplerate if you want
  550.     to resample down to lower samplerates.
  551.     
  552.     IMPORTANT NOTE:
  553.     - You need the external programs sox and lame to run that feature,
  554.       because the provided converter script audioconvert_to_wav.sh
  555.       is based on that programs.
  556.     - If you have another external audio converter program, you can configure
  557.       GIMP-GAP to use that program rather than the standard converter script
  558.       audioconvert_to_wav.sh
  559.       
  560.       The preferred way is to edit your gimprc file and add a line
  561.       like this on:
  562.       (audioconvert_program "/usr/local/bin/my_private_audioconverter")
  563.  
  564.           The 2nd way is to set an Environmentvariable:
  565.       export AUDIOCONVERT_TO_WAV=/usr/local/bin/my_private_audioconverter
  566.       
  567.  
  568.     Playback Alternatives:
  569.  
  570.       You can convert your frames to one multilayer image
  571.          menu:  <image>/Video/Frames to Image)
  572.       And then playback the newly created Image
  573.          menu:  <image>/Filters/Animation/Playback
  574.      
  575.      The GIMP-GAP VCR Navigator dialog playback button
  576.      makes those steps automatic when the SHIFT Key
  577.      is pressed together with the mouseclick,
  578.      The playback multilayer image contains only the selected frames,
  579.      or all frames if no selection was made.
  580.      
  581.  
  582.  
  583. - Move Path (make things move)
  584. - ----------------------------
  585.  
  586.       Start from Menu:
  587.           (<Image>/Video/Move Path)
  588.  
  589.  
  590.       For this plug-in you need a series of frames (destination video frames)
  591.       and one single image or another series of frames. (source object or moving object)
  592.       If you use a single image as source object all the layers in it
  593.       can be used as source frames.
  594.       
  595.       The source frames are copied into the destination frames.
  596.       This copy can be transformed in many ways, using controlpoints
  597.       and appears as one new layer in each handled destination frame.
  598.       The X/Y controlpoint coordinates affects the offest of the copied new layer
  599.       in the destination frame(s). All controlpoints build up a path
  600.       that defines how the copied new layer moves within the destination frames.
  601.       
  602.  
  603.       - The source image must be opened in the GIMP
  604.       - The source image must be another Image than the destination frame
  605.         (if you really want to copy layers from destination frame
  606.          to destination frame(s) you have to duplicate it first)
  607.       - The source image must be from the same type (RGB, INDEXED ..) as
  608.         the destination frame.
  609.  
  610.         In other words: To run the 'Move Path' plug-in you have to open at
  611.                         least 2 images of the same type.      
  612.       
  613.       
  614.             
  615.       The selected layer(s) of the source image or frame 
  616.          is (are) copied into the selected range of frames.
  617.          Each handled frame recieves exactly one copy of the selected layer
  618.          from the source image, where the copy will be modified by
  619.          transformations such as scaling, changing transparency and more,
  620.          according to the controlpoint settings.
  621.          
  622.       If you use stepmodes "Loop", "Loop Reverse", "Once", "OnceReverse" or "PingPong"
  623.         the layers of the source image are stepped through,
  624.         and the next handled frame recieves the next
  625.         layer from the source image's layerstack.
  626.         
  627.         For the frame based stepmodes ("Frame Loop", "Frame PingPong" ...)
  628.         the selected source(layer) should be a layer of another video frame.
  629.         In the frame based stepmodes the source object is considered
  630.         as video frames and stepping is done from frame to frame
  631.         (and not from layer to layer)
  632.         The inserted layer is always a copy of one frame of the
  633.         source object animation (no matter which source layer was selected)
  634.         where all the visible source layers are merged to build up the moving object.
  635.         
  636.         The frame based modes can be used to mix videos with many frames,
  637.         because there is no need to convert one of the videos to
  638.         a multilayer image.
  639.     
  640.     If you use a normal image (that is not a video frame) as source
  641.     for the frame based stepmodes it acts like an animation with 
  642.     only one frame.
  643.         
  644.       The "Step Speed" factor
  645.         decides how fast to step through the source object,
  646.         in relation to the target frames. 
  647.         With factor 1.0 source and target will step synchron.
  648.         Factor 0.5 slows down the source steps to half speed.
  649.         The same source layer is copied into 2 frames,
  650.         before the advance to the next source layer is done.
  651.         
  652.         The "Step Speed" factor is not relevant for the 
  653.         stepmodes "None" and "FrameNone".
  654.  
  655.       Selection Handling
  656.         The "Move Path" plug-in can ignore or respect selections (selected Areas)
  657.         in the source image (or source frame(s))
  658.         The Optionmenu Modes are:.
  659.          - "Ignore Selection (in all Source Images)"
  660.               Ignores all selections.
  661.          - "Use Selection (from Initial Source Image)"
  662.               Takes the selection from the initial source image (or frame)
  663.               and applies it to all handled copies.
  664.               This makes all unselected pixels of the moving object
  665.               transparent. You can get smooth edges
  666.               depending on the feather_radius settings in the controlpoints.
  667.          - "Use Selections (from all Source Images)"
  668.               Uses all selections in all source frames.
  669.               The source frames without selections are handled
  670.               as if all pixels were selected.
  671.               This mode is only relevant for the frame based stepmodes, 
  672.              "Frame Loop", "Frame Once", "Frame Loop Reverse",
  673.              "Frame OnceReverse", "Frame PingPong"
  674.                
  675.       
  676.       
  677.       The copies of the source layer(s) were modified by transitions
  678.         with varying parameters.
  679.         Parameters:
  680.        - SourceLayer (depends on Stepmode)
  681.         - Position (X/Y)
  682.         - Size Scaling (Width/Height)
  683.         - Opacity
  684.         - Rotation (angle from -360 to +360 degrees)
  685.         - Selection Feather Radius (in Pixels)
  686.            the feather radius controls how much to smooth the edges of the selections
  687.            (this is only relevant for source selection handling modes other than
  688.            "Ignore Selection")
  689.         - Perspective Transformation (transformation factors for X/Y of the 4 Corner Points)
  690.  
  691.            Perspective transformation factors are scaling factors
  692.            that are applied to the coordinates of the 4 corners.
  693.            If all 8 Coordinates have the value 1.0 no scaling is done
  694.            and the result is the same as the original.
  695.            Scaling with factor 0 moves the affected (x or y) coordinate to the middle.
  696.            Factor 2.0 applied to Coorinate moves it outwards by half of the
  697.            original width (for X coordinates)
  698.            or hlaf height (for Y coordinates).
  699.  
  700.                  1/1                       1/1
  701.                   +------------+------------+
  702.                   |            |            |
  703.                   |  x1/y1     |    x2/y2   |
  704.                   | 0.5/0.5    |   0.5/0.5  |
  705.                   |    o...............o    |
  706.                   |   .        |        .   |
  707.                   |  .         |         .  |
  708.                   | .          |0.0       . |
  709.                   +------------+------------+
  710.                  .|            |            |.
  711.                 . |            |            | .
  712.                .  |            |            |  .
  713.               .   |            |            |   .
  714.              .    |            |            |    .
  715.             .     |            |            |     .
  716.            .      |            |            |      .
  717.           .       +------------+------------+       .
  718.          .       1/1                       1/1       .
  719.         .                                             .
  720.        o...............................................o
  721.      1.5/1.5                                          1.5/1.5
  722.       x3/y3                                            x4/y4
  723.  
  724.  
  725.  
  726.       The controlpoint parameters were changed linear from one starting
  727.       controlpoint to the next controlpoint.
  728.       Per default the move path has only only 1 controlpoint.
  729.       (So the source layers(s) are copied to all frames of the framerange
  730.        at constant position, size and opacity)
  731.       If you want your source layers to move, grow, rotate or to fade (in or out)
  732.       you have to add one more controlpoints (limited to 1024) to define a path.
  733.  
  734.       The affected range is selected by  start frame - end frame.
  735.       Each affected frame recieves exactly one copy of the (current)
  736.       source layer adjusted to the current controlpoint prameters.
  737.       The layerstack defines if the pasted copy appears
  738.       in the foreground (0 == on top) or below other layers that are
  739.       already in the frame.
  740.       With the toggle button 'Clip To Frame' the the copied layer
  741.       is clipped to the destination frames image width and height.
  742.        
  743.       With the frame number in the preview frame you can select the 
  744.       frame number to display in the preview.
  745.       You have to press the "UpdPreview" button for explicite
  746.       update of the preview.
  747.  
  748.      Controlpoints:
  749.        The move path is defined by contolpoints.
  750.        Only the current cotrolpoint is displyed with all
  751.        its values.
  752.  
  753.        If checkbutton "Show Path" is on, all the controlpoints
  754.        are shown in the preview window, connected with pathlines.
  755.        Furter it enables picking controlpoints
  756.        and draging controlpoint koordinates (X/Y)
  757.        in the preview with the left mousebutton.
  758.        With the right mousebutton you always drag
  759.        the coordinates of the current controlpoint
  760.        (without picking other controlpoints)
  761.        
  762.  
  763.        There are controlpoint edit buttons to
  764.           "Add Point"
  765.       "Insert Point"  "Delete Point"
  766.  
  767.        With the Buttons
  768.           "Prev Point"    "Next Point"
  769.       "First Point"   "Last Point"
  770.           you can step from controlpoint to controlpoint,
  771.       and make other controlpoint to the curremt controlpoint.
  772.       
  773.        "Reset Point"  "Reset All Points"
  774.           does reset width, height and opacity of the controlpoint to 100%
  775.           , perspective factors to 1.0 (no perspective tansformation)
  776.       and rotation to 0 degree, 
  777.       but leaves the path (X/Y values) unchanged.
  778.     
  779.        "Delete All Points"
  780.           removes all controlpoints.
  781.       
  782.        "Rotate Follow"
  783.           Calculate rotate values for all controlpoints
  784.       to follow the path.
  785.       An object moving along a horizontal line 
  786.       from left to right results in an angle of 0 degree.
  787.       (or a multiple of 360 degress if the path
  788.        builds circular loops)
  789.       A vertical Move from top to bottom gives 90 degrees.
  790.       
  791.       SHIFT: If this button is clicked while the
  792.       Shift Key is pressed, a fix rotation offset
  793.       is added to all the calculated rotation values.
  794.       The rotation offset is taken from the current
  795.       rotate value of controlpint 1.
  796.       
  797.       If an object moves from right to left
  798.       the calculated angle is 180 degree and the object
  799.       appears upside down. 
  800.       With a startoffset of 180 (or -180)
  801.       you can compensate this effect.
  802.       
  803.        "Save Points"
  804.           saves your controlpoints to file
  805.  
  806.        "Load Points"
  807.           loads controlpoints from file
  808.          
  809.  
  810.       The "Instant Apply" checkbox
  811.          does automatic update of the preview when checked.
  812.          The automatic update needs much CPU and IO power
  813.          especially when big images are used as source and/or destination
  814.          or those images have many layers.
  815.          (dont use the instant_apply on slow machines.)
  816.       
  817.       Tips:
  818.          - with the UpdPreview Button (or "Instant Apply" checkbox)
  819.            you can blend in the
  820.            selected layer of the source image.
  821.            If you want to adjust position it may be useful to see
  822.            the background.
  823.            Therfore you can make the source image
  824.            transparent (modify the opacity value) or
  825.            put the sourcelayer below the background
  826.            (set the layerstack to higher value)
  827.            Then pres UpdPreview button again.
  828.          
  829.          - Whats wrong if the "UpdPreview" was pressed, 
  830.            but the preview does not show the source object ?
  831.            - maybe the source object is an invisible layer.
  832.              (if the "Force Visibility" checkbox is turned ON
  833.               invisible Layers should become visible).
  834.            - maybe the current opacity setting is 0% (or nearly 0%)
  835.            - maybe the current X and/or Y position are outside
  836.              the image
  837.            - maybe the current scaling factors are 0% (or nearly 0%)
  838.              and the result is only 1x1 pixel or smaller
  839.            - maybe the source object has only fully transparent pixels
  840.  
  841.          
  842.          - If you let your objects (source layers) rotatate,
  843.            perform perspective transformations or
  844.            change their size, set handle mode to 'Center'.
  845.            
  846.            If you use another handle mode you may get unwanted
  847.            moves of your object, caused by resizing.
  848.            
  849.          
  850.          - Speed:
  851.        If no keyframes are set,
  852.            the "Move Path" plug-in alternates the settings linear from
  853.            controlpoint to controlpoint, so things move (or happen) in constant speed
  854.            between 2 controlpoints.
  855.            
  856.            If you want to make accelerated moving obcets, you'll
  857.            have to set more controlpoints with growing distances.
  858.            
  859.            Example:
  860.            
  861.            [1] [2]  [3]   [4]    [5]     [6]
  862.             +---+----+-----+------+-------+
  863.  
  864.            The affected range has 25 frames, and you have set 6 points
  865.            with growing distances in one straight line and without
  866.            specifiying keyframes for those points.
  867.            That gives 5 frames (== equal time) for each part of the path,
  868.            but each part has another length. This results in different
  869.            (growing) speeds for each part of the path.
  870.            
  871.            
  872.            
  873.     - Keyframes
  874.         
  875.     Keyframes can be used optional, to fix a controlpoint
  876.     to the given frame number. The first and last controlpoints
  877.     are implicite keyframes, always fixed to start or end
  878.     frame number. (The keyframe entry is set insensitive
  879.     on the first and last contolpoint)
  880.     With the help of keyframes you can control exactly
  881.     when things should happen.
  882.     
  883.     Use a value of 0 in the keyframe entry if you dont want
  884.     to fix a controlpoint to a keyframe.
  885.     
  886.     Keyframes are shown as absolute frame number
  887.     in the "Move Path" dialog window, but they
  888.     are saved as relative values in the
  889.     pointfile.
  890.     (if start frame = 5
  891.      and a keyframe is displayed as 7
  892.      the keyframe is internally stored as 2 (7 - 5)
  893.      
  894.      - Check Controlpoints
  895.         - The check is done at "OK", and "Anim Preview"
  896.       button,
  897.       If errors are detected, they are shown
  898.       in a pop-up window and the action is not performed.
  899.         - The number of cntrolpoints is now checked
  900.       against the number of affected frames.
  901.       (You can't have more controlpoints than frames)
  902.     - If keyframes are used, they must be in
  903.       (ascending or descending) sequence
  904.      
  905.           
  906.      - AnimPreview
  907.         With this button you can generate an animated preview
  908.     to get an idea how the inserted moving object
  909.     will look like. The animated preview is generated
  910.     as multilayer image and the Filter/Animation/Playback
  911.     plug-in is started on that multilayer image.
  912.     
  913.     The button opens a dialog window, where you can
  914.     enter options for the animated preview.
  915.     
  916.     - Object on empty frames
  917.         renders quick on empty frames (filled with background color)
  918.         (scale down speeds up rendering time)
  919.     - Object on one frame
  920.         renders quick on one frame (preview frame)
  921.         (scale down speeds up rendering time)
  922.     - Exact Object on frames
  923.         renders slow, but exactly on the selected framerange.
  924.         (scale down increases rendering time)
  925.  
  926.         - Scale Preview
  927.         Optional you can scale down the animated preview
  928.         size (100% downto 5%)
  929.         
  930.     - Framerate
  931.         The framerate is used in the generated 
  932.         multilayer image only.
  933.         
  934.     - Copy to Video Buffer   
  935.       Optional you can copy the preview frames
  936.       to the video buffer
  937.       (can be pasted in the GIMP-GAP VCR Navigator)
  938.     
  939.     - Force visibility
  940.          If this checkbutton is set, all source layerobjects
  941.      are set visible when they are copied into frames.
  942.  
  943.  
  944.     "Move Path" advanced settings
  945.     --------------------------
  946.     
  947.     - Bluebox
  948.          With the bluebox check_button you can apply the bluebox filter effect
  949.          on the moving object, that makes the keycolor transparent.
  950.  
  951.     - The Keycolor button
  952.          Opens a dialog window where you can set all the parameters
  953.          of the bluebox filter.
  954.          If clicked with the right mouse button you can grab the keycolor
  955.          from thhe current FG/BG color (in the GIMP main window)
  956.          
  957.     
  958.     - Tracelayer
  959.          a trace layer shows all positions of the moving object
  960.      from begin until the position of the previous frame.
  961.      Positions in virtual frames (tweens) are also included
  962.      in the trace layer.
  963.      If descending Opacity is used, the trace is fading out
  964.      at the older (previous) Positions of the moving object.
  965.     
  966.     -Tweensteps
  967.         This feature is for rendering fast moving Objects.
  968.  
  969.         The "MovePath" plug-in can calculate the moving object for virtual frames (tweens)
  970.         beetween real frames. You can control this by setting tween_steps
  971.         to a value greater than 0.
  972.         In that case the "MovePath" plug-in creates an additional layer
  973.         (the "Tweenlayer") and inserts that tween layer below the
  974.         stackpostion of the current moving object in the next real frame.
  975.         The tween layer shows the moving object at the positions of
  976.         all virtual frames beetween two real frames.
  977.     
  978.         Example: The selected frame range is 10 frames and
  979.         the tweensteps value is 2. In this case 28 steps
  980.         are processed internal. 10 real frames + 18 virtual frames
  981.         (2 virtual beetween each real frame)
  982.         Use descending opacity to fade out tweens.
  983.         The tween nearest to the real frame is drawn with the initial
  984.     opacity value, the other tweens are reduced more and more
  985.     if descending opacity is less than 100%.
  986.     With tweens and opacity settings you can produce motion-blur effects
  987.     for fast moving objects.
  988.  
  989.         If both tween processing and trace layer are active, the
  990.     "Tweenlayer" is added, but set invisible.
  991.     This is done because the trace layer contains already all the tween steps.
  992.     A visible tween layer would produce unwanted increase
  993.     of the total opacity of the moving object in the composite view.
  994.  
  995.     
  996. - Convert frames to one multilayered image.
  997. - -----------------------------------------
  998.  
  999.     This can be done with
  1000.     
  1001.           menu:  <image>/Video/Frames to Image
  1002.           
  1003.     The selected source range of frames is copied into one
  1004.     new created multilayered destination Image.
  1005.     Each frame results in one layer in the destination image.
  1006.     (or nothing if the source frame has no selected layer)
  1007.     
  1008.     With the layer basename you can choose a name for the resulting
  1009.     layers in the destination Image. The string [####] is replaced
  1010.     by the frame number. 
  1011.        Example: my_layer_[##]  results in: my_layer_01, my_layer_02 .... 
  1012.     
  1013.     Layer Mergemode:
  1014.       - Extend as necessary   Build a destination layer by merging
  1015.                               selected layers of one source frame.
  1016.                               The destination layer's size will be
  1017.                               the outline-rectangle of all selected
  1018.                               layers.
  1019.                               
  1020.       - Clipped to image      Build a destination layer by merging 
  1021.                               selected layers of one source frame.
  1022.                               The destination layer's size will be
  1023.                               the image size.
  1024.                               
  1025.       - Clipped to bottom layer  Build a destination layer by merging
  1026.                               selected layers of one sourceframe.
  1027.                               The destination layer's size will be
  1028.                               the size of the lowest selected layer.
  1029.                               
  1030.       - Flattened image       Build destination layer by flattening
  1031.                               the source layers copied from one source frame.
  1032.                               There will be no transparent parts
  1033.                               in the destination layers.
  1034.                               The destination layer's size will be
  1035.                               the image size.
  1036.     
  1037.     With the 'Exclude BG-Layer' checkbutton pressed,
  1038.     the background layers of all the source frames are excluded
  1039.     from the copy, regardless if they are selected or not.
  1040.     Otherwise background layers are handled like all other layers.
  1041.    
  1042.     (If you are using flatten mode 'Flatten' the background color will fill all
  1043.      transparent parts of the resulting destination layer(s).)
  1044.  
  1045.     Layer Selection:
  1046.     ----------------
  1047.     Here you can select which layer(s) of a frame is(are) used
  1048.     to build the destination layer.
  1049.     
  1050.     Select Layer(s):
  1051.        Pattern is equal to layer name
  1052.        Pattern is start of layer name
  1053.        Pattern is end of layer name
  1054.        Pattern is a part of layer name
  1055.            With these settings you can select layers
  1056.            by their layername.
  1057.            (All layers with a layer name matching the select pattern
  1058.            are selected).
  1059.         
  1060.        Pattern is layerstack number list
  1061.            Layers are selected by their layerstack position,
  1062.            where 0 is the top layer.
  1063.            The pattern is a list of layerstack numbers or
  1064.            number ranges. (0-3 matches to the upper 4 layers)       
  1065.        Pattern is reverse-stack list"
  1066.            Here you can specify layerstack numbers in reverse order.
  1067.            (where 0 is the background layer)
  1068.            
  1069.        All Visible (ignore pattern)
  1070.            All visible layers are selected.
  1071.            (The select pattern is ignored)
  1072.        
  1073.     Select Pattern:
  1074.        String to identify a layer. It can be a part of the layer name
  1075.        or a list of layerstack numbers (like this one: "0, 2-5, 9")
  1076.        depending on your choice in select layer(s) above.
  1077.     Case Sensitive:
  1078.        Lowercase and upppercase letters are considered as equal
  1079.        if this checkbutton is set to off.
  1080.     Invert Selection:
  1081.        Select all unselected layers.
  1082.     Pixel Selection:
  1083.        How to handle selected areas in the handled frame range.
  1084.        "Ignore"
  1085.            Ignore all selections in all handled frames
  1086.        "Initial Frame"
  1087.            Use only one selection from the first handled frame,
  1088.            All unselected areas are set to transparent in the
  1089.            resulting multilayer image.
  1090.            All the resulting layers in the generated multilayer image
  1091.            are shaped by the initial selection.
  1092.        "Frame specific"
  1093.            Use selections from all handled frames.
  1094.            (Frames without any selection are handled as if all pixels were selected)
  1095.            All unselected areas are set to transparent in the
  1096.            resulting multilayer image.
  1097.  
  1098. - Frames Convert
  1099. - --------------
  1100.    Converting multiple frames from one fileformat to another:
  1101.     
  1102.           menu:  <Image>/Video/Frames Convert
  1103.  
  1104.    Basename:
  1105.       Name of one destination frame without the frame number part and without the
  1106.       extension.
  1107.       
  1108.    Extension:
  1109.       Extension of the destination frames. The extension also defines the
  1110.       fileformat.
  1111.       
  1112.    Imagetype:
  1113.       Keep Type
  1114.       Convert to RGB
  1115.       Convert to Gray
  1116.       Convert to Indexed
  1117.       
  1118.    Flatten:
  1119.       Merge all layers if checked. This check_button should be turned on
  1120.       for destination fileformats that can not store multiple layers.
  1121.  
  1122.    Example1:
  1123.       
  1124.       If your source frames are XCF-images of imagetype RGB with the names:
  1125.        img_000001.xcf
  1126.        img_000002.xcf
  1127.        img_000003.xcf
  1128.  
  1129.       and you want to convert to JPEG's named
  1130.         /tmp/scratch_000001.jpg
  1131.         /tmp/scratch_000002.jpg
  1132.         /tmp/scratch_000003.jpg
  1133.  
  1134.       you need the following convert settings:
  1135.         From Frame: 1
  1136.     To Frame:   3
  1137.     Basename:   /tmp/scratch_
  1138.     Extension:  .jpg
  1139.     Imagetype:  Keep Type
  1140.     Flatten:    ON (checked)
  1141.       
  1142.  
  1143.    Example2:
  1144.       
  1145.       To convert from RGB JPEG fileformat (.jpg) to GIF (.gif)
  1146.       you have to set the destination imagetype "Convert to Indexed",
  1147.       because the GIF fileformat can not handle RGB, only GRAY and INDEXED)
  1148.               
  1149.       Convert to INDEXED reduces the number of colors
  1150.       downto 256 (or less).
  1151.  
  1152.  
  1153. - Modify Frames
  1154. - --------------
  1155.     Start from Menu:
  1156.        <Image>/Video/Frames Modify
  1157.     
  1158.     The GIMP-GAP plug-in 'Frames Modify' provides the feature to perform functions
  1159.     on one ore more selected layer(s) in all frames of the selected frame range.
  1160.     
  1161.     The layers can be selected by (parts of) their name, or by their
  1162.     layerstack numbers.
  1163.     (for more information on layer selection see above
  1164.     at chapter "Convert frames to one multilayered image").
  1165.     
  1166.     Available Functions are:
  1167.        "Set Layer(s) visible",
  1168.        "Set Layer(s) invisible",
  1169.        "Set Layer(s) linked",
  1170.        "Set Layer(s) unlinked),
  1171.        "Raise Layer(s)",
  1172.        "Lower Layer(s)",
  1173.        "Merge Layer(s) expand as necessary",
  1174.        "Merge Layer(s) clipped to image",
  1175.        "Merge Layer(s) clipped to bg-layer",
  1176.        "Apply filter on Layer(s)",
  1177.        "Duplicate Layer(s)",
  1178.        "Delete Layer(s)",
  1179.        "Rename Layer(s)",
  1180.        "Replace Selection",
  1181.        "Add Selection",
  1182.        "Subtract Selection",
  1183.        "Intersect Selection",
  1184.        "Selection None",
  1185.        "Selection All",
  1186.        "Selection Invert",
  1187.        "Save Selection to Channel",
  1188.        "Load Selection from Channel",
  1189.        "Delete Channel (by Name)"
  1190.        "Add alpha channel",
  1191.        "Add white layermask (opaque)",
  1192.        "Add black layermask (transparent)",
  1193.        "Add layermask from alpha",
  1194.        "Add layermask transfer from alpha",
  1195.        "Add layermask from selection",
  1196.        "Add layermask from bw copy",
  1197.        "Delete layermask",
  1198.        "Apply layermask"
  1199.  
  1200.  
  1201.     The Functions 
  1202.        "Replace Selection",
  1203.        "Add Selection",
  1204.        "Subtract Selection",
  1205.        "Intersect Selection",
  1206.     take the Selection from the initial (invoking) frame and combines it
  1207.     with existing selections in all the other handled frames.
  1208.  
  1209.     The Functions:
  1210.     "Duplicate Layer(s)"
  1211.     "Rename Layer(s)"
  1212.     "Save Selection to Channel"
  1213.     "Load Selection from Channel"
  1214.     "Delete Channel (by Name)"
  1215.     require a Name in the Entry field "New Layer or Channel Name:"
  1216.  
  1217.     
  1218.     The function 'Apply filter on Layer(s)' brigs up a dialog window that is
  1219.     similar to the PDB-Browser, where you can select any available
  1220.     filter.
  1221.  
  1222.     If you use the PDB-Browser's button "Apply Varying", the
  1223.     filterparameters will slightly change in each handled frame
  1224.     from start to end.
  1225.  
  1226.        - If there is more than one selected layer in a frame
  1227.          each of the selected layers within the same frame
  1228.          will be processed with the same filter parameter values.
  1229.     
  1230.          (for more information see chapter 'Animated calls of Plug-In Filters' below)
  1231.  
  1232.  
  1233.  
  1234.     It is a good idea to use the same layerstack structure in all
  1235.     your frames. Another hint is that you assign useful names to
  1236.     your layers. that should be done consequent for all frames.
  1237.     
  1238.     Example 1 (useful Layertack structure/names)
  1239.     
  1240.     
  1241.                     film_000001.xcf    film_000002.xcf  ....  film_000010.xcf       
  1242.     ---------------------------------------------------------------------
  1243.     
  1244.     layerstack [0]  mouse_01         mouse_02              mouse_10
  1245.     layerstack [1]  cat_01           cat_02                cat_10
  1246.     layerstack [2]  tree_01          tree_02               tree_10
  1247.     layerstack [3]  background       background            background
  1248.     
  1249.  
  1250.     
  1251.     Example 2 (not recommanded)
  1252.     
  1253.     
  1254.                     film_000001.xcf    film_000002.xcf  ....  film_000010.xcf       
  1255.     ---------------------------------------------------------------------
  1256.     
  1257.     layerstack [0]  tree             layer                 mouse_10
  1258.     layerstack [1]  bg               layer                 cat_10
  1259.     layerstack [2]                   layer                 background 
  1260.     layerstack [3]                   background                       
  1261.     
  1262.  
  1263. - Renumber Frames
  1264. - ---------------------------------
  1265.  
  1266.   Start from Menu:
  1267.        <Image>/Video/Frames Renumber
  1268.  
  1269.   This plug-in renumbers all frames (discfiles) of a video.
  1270.   
  1271.   First Frame Number:
  1272.      Enter the new number for the first frame in this
  1273.      entry field.
  1274.      All frames of video are renumbered, starting at this
  1275.      number.
  1276.  
  1277.   Digits:
  1278.     Here you can enter how many digits (1 up to 6) to use for your frame
  1279.     numbers. Framenumbers are fileld up with leading zeros to the
  1280.     specified number of digits.
  1281.     Framenumbers that are greater than the specified number of digits
  1282.     will use more digits than specified, but are built without leading zeroes.
  1283.     If you choose 1 your framenumbers are built without
  1284.     any leading zeroes at all.
  1285.  
  1286.  
  1287.   If the frames are numbered in a non-continous way, you can
  1288.   make them continous with this plug-ins.
  1289.   (Most other GIMP-GAP features do not accept non-continous numbered frames)
  1290.  
  1291.   Example:
  1292.     you have the frames:
  1293.        film_0001.xcf
  1294.        film_0007.xcf
  1295.        film_0008.xcf
  1296.  
  1297.   After running the renumber feature with settings
  1298.     First Frame Number: 4
  1299.     Digits: 6
  1300.  
  1301.     the frames will be renumbered as:
  1302.  
  1303.        film_000004.xcf     # old name was film_0001.xcf
  1304.        film_000005.xcf     # old name was film_0007.xcf
  1305.        film_000006.xcf     # old name was film_0008.xcf
  1306.     
  1307.   
  1308. - Render Filename to Layer
  1309. - ---------------------------------
  1310.  
  1311.   Start from Menu:
  1312.        <Image>/Video/
  1313.  
  1314.   This plug-in renders the filename of the image
  1315.   or just the number part of the filename onto the image.
  1316.   If the parameter create_new_layer is 0, the filename is rendered 
  1317.   to the active drawable (the layer that was active when
  1318.   this plug-in was invoked).
  1319.   Otherwise a new textlayer is created.
  1320.   
  1321.   Mode:
  1322.     "Number Only"     ... render just the number part
  1323.     "Filename"        ... render the filename without directory path
  1324.     "Path/Filename"   ... render the filename including the directory path
  1325.     
  1326.   Fontname:
  1327.     Entry for the Fontname
  1328.     
  1329.   Fontsize:
  1330.     Fontsize in pixels
  1331.     
  1332.   PosX:
  1333.     Position x offset in pixels
  1334.     
  1335.   PosY:
  1336.     Position y offset in pixels
  1337.     
  1338.   Antialias:
  1339.     ON: Use Antialiasing
  1340.     OFF: No Antialiasing
  1341.     
  1342.   Create Layer:
  1343.     ON: Create a new layer,
  1344.     OFF: Render on the active drawable
  1345.  
  1346.  
  1347.   Tip:
  1348.   To create framenumbers in all of your frames
  1349.   you can use the "Modify Frames" (<Image>/Video/Frames Modify) feature
  1350.   and choose "Apply filter on Layer(s)" as function.
  1351.   In the next dialog step, the GIMP-GAP DB-Browser window
  1352.   select "plug_in_gap_renumber" as filter name.
  1353.   (this is the internal PDB-Name of the "Render Filename to Layer" plug-in)
  1354.   
  1355.   Then choose "Apply constant" in the DB-Browser window.
  1356.   This should open the "Render Filename to Layer" dialog window
  1357.   (only for the first frame) where you can adjust the settings.
  1358.   Choose "Number Only" mode for rendering only the framenumber part,
  1359.   and "Create Layer" checkbutton turned on if you want the number to be created
  1360.   as seperate layer.
  1361.   With "Create Layer" turned off the number will be rendered on (all)
  1362.   the layer(s) that were selected in the initial "Modify Frames" dialog window.  
  1363.  
  1364.  
  1365. - Change Frame Density
  1366. - ---------------------------------
  1367.  
  1368.   Start from Menu:
  1369.        <Image>/Video/Frames Density
  1370.  
  1371.   Changing the frame density results in duplicating frames
  1372.   for increasing frame density, and will delete frames
  1373.   for decreasing the density.
  1374.  
  1375.   This feature is used to change the target framerate.
  1376.  
  1377.   Example:
  1378.   If you have created an animation with framerate of 8 frames/sec
  1379.   and want to change to a target framerate of 24 frames/sec.
  1380.   You should call the "Frame Density" plug-in with a density factor
  1381.   of 3 and increasing density mode.
  1382.  
  1383.   This makes 2 copies for each of the frames in the selected range.
  1384.   If you use playback at the old 8 frames/sec rate the motion
  1385.   is 3 times slower now. With the new Rate of 24 Frames/sec
  1386.   the motion is the same speed as before. 
  1387.  
  1388.   The animation before the frame density change (frames 1-9):
  1389.  
  1390.      01 02 03 04 05 06 07 08 09   (original framenumber)
  1391.  
  1392.   The animation after frame density change at growing mode and factor 3
  1393.   and limited to a frame range from frame 3 to frame 8:
  1394.  
  1395.      01 02 03 04 05  06 07 08 09 10 11  12 13 14   15 16 17 18 19 20 21   (new framenumber)
  1396.      01 02 03 03 03  04 04 04 05 05 05  06 06 06   07 07 07 08 08 08 09   (original framenumner)
  1397.                +  +      +  +     +  +      +  +       +  +     +  +   
  1398.  
  1399.   Tip:
  1400.      To get smooth motion in the resulting frames you may create 
  1401.      2 onionskin layers per frame (for the range "FromFrame" 03 "ToFrame" 20)
  1402.      using a setting that blends in the next 2 frames ("FrameReference" +1) 
  1403.      at stackposition 0 FromTop of the layerstack
  1404.      with opacity of 66% and 50% and without ignoring any background layer(s).
  1405.      
  1406.      That way you get a cross-fading effect with smoother motion
  1407.      when played with 24 Frames/sec
  1408.  
  1409.      You can find onionskin in this menu:
  1410.      <Image>/Video/Onionskin/Configuration
  1411.     
  1412.      
  1413.   Density factors are limited to values from 1.0 upto 100.0.
  1414.   float values are supported.
  1415.   
  1416.  
  1417.   If you want to change from 30 frames/sec down to 15 frames/sec
  1418.   then use a density factor of 2 and decreasing density mode
  1419.   (increasing/growing mode switched off).
  1420.   
  1421.   This will delete every 2.nd frame.
  1422.   
  1423.   There is no undo, so use this feature very carefully.
  1424.  
  1425.  
  1426. - Blubox Filter
  1427. - --------------
  1428.     Start from Menu:
  1429.        <Image>/Video/Bluebox
  1430.  
  1431.     The bluebox filter makes the selected keycolor transparent.
  1432.     The bluebox filter operates on a single layer that must be of RGB(A) type.
  1433.     (INDEXED and GRAY images are not supported)
  1434.     
  1435.     Keycolor:
  1436.       This colorbutton shows the wanted keycolor. Pixels that are similar
  1437.       to this color can be set more or less transparent by the bluebox filter.
  1438.       You can define the detection of similar colors by Threshold(s) in
  1439.       4 different ways depending on threshold mode:
  1440.       
  1441.     Threshold Mode:
  1442.       HSV ..... has 3 seperate thresholds for hue, saturation and value
  1443.                 and operates in the HSV colormodel.
  1444.       RGB ..... has 3 seperate thresholds for red, green and blue channels
  1445.                 and operates in the RGB colormodel
  1446.       VALUE ... has only one single threshold for the maximum difference
  1447.                 of red, green, and blue channels and operates in the RGB colormodel.
  1448.       ALL ..... has 6 seperate thresholds for HSV and RGB
  1449.  
  1450.     Thresholds
  1451.       All thresholds have the range from 0.0 to 1.0
  1452.       where 0.0 has no tolerance the compared channel (requires exact match)
  1453.       and 1.0 allows the maximum tolerance (all values will match)
  1454.  
  1455.        
  1456.     Alpha Tolerance:
  1457.       Alpha tolerance value 0.0 upto 1.0
  1458.       where 0.0 makes hard pixel selection by color threshold(s)
  1459.       greater values allow more or less variable transparency (alpha channel values)
  1460.       for the selected pixels within the threshold(s)
  1461.       depending on their difference to the keycolor.
  1462.       Pixels with color equal or near the keycolor appear more transparent
  1463.       than pixels with more color differnce.
  1464.       Pixels with color differences bigger than the threshold(s)
  1465.       are not affected by the "Alpha Tolerance" setting.
  1466.  
  1467.     
  1468.     Source Alpha:
  1469.       Select only pixels with alpha channel >= source_alpha
  1470.       where 0.0 is full transparent, 1.0 is full opaque.
  1471.       Normally this is set to 0.2 to protect the alpha_channel
  1472.       of pixels that are already transparent against changes
  1473.       by the bluebox filter.
  1474.       
  1475.     Target Alpha:
  1476.       Control the minimum alpha value for the selected pixels.
  1477.       where 0.0 sets a full selected pixel (== matching with keycolor)
  1478.       to full transparent,
  1479.       0.5 sets a full selected pixel to half transparent
  1480.       and 1.0 to full opaque.
  1481.       
  1482.     Feather Edges:
  1483.       Enable smoothing the selection using the feather radius.
  1484.       
  1485.     Feather Radius:
  1486.       Feather radius in pixels, makes the selection smooth.
  1487.       (this is done internally by applying a blur filter on the 
  1488.        selection that was built by keycolor, threshold(s) alpha tolerance,
  1489.        shrink/grow and target alpha settings)
  1490.    
  1491.     Shrink/Grow:
  1492.       Grow or shrink the selection in pixels,
  1493.       where negative values are for shrinking the selection
  1494.       (that was built by keycolor, threshold(s) alpha tolerance,
  1495.        and target alpha settings)  
  1496.     
  1497.     
  1498.     The bluebox filter creates an image for preview of the effect.
  1499.     This image contains an (optinal scaled) copy of the original layer.
  1500.     
  1501.     Automatic Preview:
  1502.       When checked perform automatical update of the preview image 
  1503.       on all changes of the parameter settings.
  1504.     
  1505.     Preview Button:
  1506.       Create or update the preview image.
  1507.     
  1508.     Previewsize:
  1509.       Set size of the preview image in percent of the original.
  1510.     
  1511.  
  1512.  
  1513. - Saving frames to Videofiles:
  1514. - ----------------------------
  1515.  
  1516.     The GIMP-GAP base package provides only frontend dialogs to call MPEG
  1517.     encoding programs.
  1518.     You must have installed one of them if you want to save
  1519.     your finished video frames in MPEG video fileformat.
  1520.     
  1521.     UNIX Users can install the optional GIMP-GAP video encoder package,
  1522.     to save (==encode) frames in MPEG and other videoformats on the fly.
  1523.     
  1524.     ==> the  GIMP-GAP video encoder Package is available for GIMP-1.2.x
  1525.         porting to GIMP-1.3 will start in december 2003
  1526.  
  1527.     The MPEG-encoders are:
  1528.  
  1529.         1) mpeg_encode 1.5    
  1530.        freely distributed Berkeley MPEG-1 Video  encoder
  1531.        ftp://mm-ftp.cs.berkeley.edu/pub/multimedia/mpeg/bmt1r1.tar.gz
  1532.        
  1533.        (Can read video frames in the fileformats:
  1534.           .yuv 
  1535.           .ppm
  1536.           .pnm
  1537.           .jpg
  1538.        )
  1539.        (can call filterprograms to convert from other fileformats)
  1540.     
  1541.     2) mpeg2encode 1.2
  1542.        MPEG-2 and MPEG-1 encoder / decoder, version 1.2
  1543.        (MPEG Software Simulation Group)
  1544.        
  1545.        Web:      http://www.mpeg.org/MSSG
  1546.        FTP:      ftp://ftp.mpeg.org/pub/mpeg/mssg
  1547.        E-mail:   mssg@mpeg.org  (author contact)
  1548.  
  1549.        (Can read video frames in the Fileformats:
  1550.           .yuv 
  1551.           .ppm
  1552.        )
  1553.  
  1554.      To prepare for MPEG encoding:
  1555.      
  1556.      - Use 'Frames Convert' from the video menu 
  1557.        to convert your video frames to .ppm 
  1558.        (or another fileformat that can be read directly by
  1559.         your encoder)
  1560.       
  1561.      - If you have a layerstack-animated multilayer image
  1562.        you can use 'Split Img to Frames' from the video menu.
  1563.      
  1564.      - If you are using mpeg_encode and
  1565.        height or width are not multiples of 16:
  1566.           Use 'Frames Scale' or 'Frames Crop' from the video menu
  1567.           on the newly converted/created video frames.
  1568.      
  1569.      - Then use 'Encode/MPEG2 (mpeg2encode)' or 'Encode/MPEG1 (mpeg_encode)'
  1570.        from the video menu.
  1571.        (Invoked from one of the prepared video frames)
  1572.        
  1573.        Both encoders offer a lot of parameter settings for the experienced
  1574.        User. The parameters are passed to the encoder in a parameterfile.
  1575.        The frontend dialog shows only the most important parameters,
  1576.        but generates a documented parameterfile with default values
  1577.        for the other parameters.
  1578.        You can generate the parameterfile with or without starting
  1579.        the encoder.
  1580.        (You may start the encoder later by executing the startscript
  1581.         from a Unixshell. The startscript is generated by the frontend dialog)
  1582.        
  1583.        For more information on the parameters please refer to the encoders
  1584.        documentations.
  1585.        
  1586.       
  1587. - NO UNDO:
  1588. - --------
  1589.   There is no Undo for the video frame based GIMP-GAP video plug-ins.
  1590.   If you step to the next frame (menu: <image>/Video/Goto Next)
  1591.   the current frame is saved to disk and the next frame
  1592.   is loaded into the image. 
  1593.   All undo steps were cleared at this time.
  1594.  
  1595.  
  1596. - About Locks
  1597. - -----------
  1598.  
  1599.    All the GIMP-GAP plug-ins are using a lock.
  1600.    This lock disables to run other GIMP-GAP plug-ins (or the same plug-in twice)
  1601.    on the same image at the same time,
  1602.    while the current GIMP-GAP plug-in is working on that frame.
  1603.    
  1604.    GIMP-GAP keeps a locktable (for the current session) that contains
  1605.    the image_id's of all images currently locked by GIMP-GAP plug-ins.
  1606.  
  1607.    If you cancel a running GIMP-GAP plug-in with the cancel button
  1608.    in the progress window,
  1609.    or kill it from your operating sytem the lock may remain.
  1610.    (This should only happen to WINDOWS users, for UNIX users
  1611.     locks are checked for dead process ids)
  1612.  
  1613.    To unlock you can save the current frame image,
  1614.    close all views to that image, then reload the frame image.
  1615.    (or quit and restart the GIMP)
  1616.  
  1617.   WARNING:
  1618.   It is not recommanded to open more than one frame of
  1619.   an animation at the same time.
  1620.   (menu: File/Open "img_000001.xcf"
  1621.    menu: File/Open "img_000002.xcf")
  1622.   
  1623.   In this constellation both gap plug-ins may concurrent 
  1624.   in save/load to/from the same file.
  1625.   Example:
  1626.      call from "img_000001.xcf" Video/Delete Frames (range 000001 to 000003)
  1627.            now img_000004.xcf is renamed to img_000001.xcf
  1628.                img_000005.xcf is renamed to img_000002.xcf
  1629.  
  1630.      then  
  1631.      call from "img_000002.xcf" Video/Goto First
  1632.             the img_000002.xcf (its old content) is saved,
  1633.                              overwiting wht was img_000004.xcf before.
  1634.   If you make the 2.nd call while the 1.st one is in progress,
  1635.   you may trash your frames (2 writers on one file) and/or crash
  1636.   your GIMP session.
  1637.  
  1638.  
  1639. - Animated calls of plug-in filters:
  1640. - ----------------------------------
  1641.  
  1642.   First of all, you need a multilayered Image.
  1643.   You can use "<Image>/Video/Frames to Image"
  1644.   to create one from a series of frames,
  1645.   or duplicate the backround layer of a single layered image
  1646.   (Press Ctrl-C within the layers dialog window N-times)
  1647.  
  1648.   Then call from wihin the multilayer image:
  1649.  
  1650.       "<Image>/Filters/Filter all Layers"
  1651.   
  1652.   You'll get a window similar to the PDB-Browser, that shows
  1653.   all available plug-ins in a listbox (and informations about
  1654.   the selected plug-in on the right side).
  1655.  
  1656.   Note: The listbox does not show the full PDB.
  1657.         (Plug-Ins without run-mode, image, drawable parameters
  1658.          are never listed here, regardless to your wildcard selection)
  1659.   
  1660.   Select one of the listed plug-ins and press one of the buttons:
  1661.  
  1662.   "Apply Varying":
  1663.       The selected plug-in is called 2 times in interactive mode,
  1664.       1. for the backround layer
  1665.       2. for the top layer.
  1666.       
  1667.       For all further layers, the plug-in will work non-interactive
  1668.       with the iterated inbetween values.
  1669.       Therefore the plug-in must have an "_Iterator" or "_Iterator_ALT"
  1670.       procedure, to modify the "last stored values"
  1671.        
  1672.       (GIMP-GAP provides such procedures for more than 50 existing plug-ins)
  1673.       
  1674.       If the iterator procedure is not available, the
  1675.       "Apply Varying" button is set insensitive on the selected procedure.
  1676.       
  1677.       Note:
  1678.             It is possible to iterate values of the type PARAM_DRAWABLE,
  1679.             (such as the BumpMap in plug_in_bump_map:
  1680.             You may use a layerstack-animated Image as animated Bump-map)
  1681.             This will only work, if from and to values are layers within the same image.
  1682.             The iteration is done on the layerstackindex in that case.
  1683.             and the inbetween values for the non-interactive filtercalls
  1684.             will be the layers between the from and to layerstackindex.
  1685.             (an animation sequence as the user might expect)             
  1686.   
  1687.   "Apply Constant":
  1688.       The selected plug-in is called only once in interactive mode,
  1689.       For all further layers, the plug-in will work non-interactive
  1690.       using the last stored values.
  1691.  
  1692.  
  1693.   The script sel-to-anim-img.scm simplifies the creation of animated
  1694.   images. Invoke the script from:
  1695.  
  1696.              "<Image>/Script-Fu/Animators/Sel To AnimImage"
  1697.              
  1698.   The script creates a new image with n copies of the current selection.
  1699.   Then it invokes the animated call of plug-in filters (optional)
  1700.   on the generated new image.
  1701.  
  1702.   Note: - Some plug-ins may not work correct or crash when called
  1703.           in NON_INTERACTIVE mode. (see TESTPROT_iter_ALT)
  1704.         
  1705.         - Some pug-in's in your PDB can have earlier or later versions
  1706.           If their interfaces were changed and does not match with the
  1707.           interface version of the iterator procedure
  1708.           you get the message:(in the shell window)
  1709.         
  1710.                ERROR: xxxx_Iterator stored Data missmatch in size N != M
  1711.                
  1712.           when using the "Apply Varying" button.
  1713.           In that case you can try to generate the needed _Iterator procedure
  1714.           for your plug-ins current interface by yourself.
  1715.           (see file: README_devlopers)
  1716.         
  1717.  
  1718. - How to write (or generate) animated plug-ins:
  1719.       (see file: README_devlopers)
  1720.  
  1721. - Filtermacro scripts:
  1722. - --------------------
  1723.  
  1724.     Start from Menu:
  1725.  
  1726.       "<Image>/Filters/Filtermacro"
  1727.  
  1728.     WARNINGS:
  1729.     - fltermacro scripts are a temporary solution. Support may be removed
  1730.       in future releases of gimp-gap. 
  1731.     - filtermacros are restricted to plug-ins that are able to run with LAST_VALUES.
  1732.     - filtermacro scriptfiles are machine dependent, plug-in version dependent, 
  1733.       and may not work in the expected way or even crash at execution on other machines
  1734.       or on execution with newer versions of the recorded filter plug-ins.
  1735.  
  1736.   Filename:
  1737.     Name of the filtermacro scriptfile.
  1738.  
  1739.   Delete All button:
  1740.     Delete the filtermacro scriptfile.
  1741.  
  1742.   Delete button:
  1743.     Delete the currently selected filtercall from the filtermacro scriptfile.
  1744.  
  1745.   Add
  1746.     Add a new filtercall to the filtermacro scriptfile.
  1747.     This button opens a PDB browser dialog window,
  1748.     where you can select filters that have been already used
  1749.     within the current GIMP-session.
  1750.     The PDB browser will show only filters that can
  1751.     operate on a drawable and have stored the parameters
  1752.     of the last run (in the current Session)
  1753.  
  1754.   Cancel
  1755.     Close the window.
  1756.  
  1757.   OK
  1758.     Close the window and apply all the filtercalls
  1759.     that are listed in the filtermacro scriptfile
  1760.     with their recorded parameters to the
  1761.     current drawable.
  1762.     (this is the drawable from where the 'Filter Macro' dialog
  1763.     was invoked from)
  1764.  
  1765.  
  1766.   Tip:
  1767.   Filtermacro execution can be used in the same way as a single
  1768.   filtercall, together with the
  1769.     'Filter All Layers'  and the 
  1770.     'Frames Modify'      
  1771.   features of gimp-gap. This way you can apply a set of filtercalls
  1772.   on all layers of a multilyer image
  1773.   (or on all selected layers in multiple frames)
  1774.   at once 
  1775.  
  1776.  
  1777. --------------------------------------------------------------------
  1778. Video Configuration (gimprc)
  1779. --------------------------------------------------------------------
  1780.  
  1781. There are optional configuration values for the GIMP-GAP video plug-ins.
  1782. Those values are stored in your personal gimprc file (located in $HOME/.gimp-1.3/gimprc)
  1783. or in the system-wide gimprc file (usually located at /usr/local/etc/gimp/1.3/gimprc)
  1784.  
  1785. If you edit gimprc files by hand, you must do this before you startup GIMP.
  1786.  
  1787.  
  1788. # there are 2 Values to define direcory and basename
  1789. # for Video Copy/Cut/Paste operations      
  1790. (video-paste-dir "/home/hof/gap_video_paste_dir")
  1791. (video-paste-basename "gap_video_paste_")
  1792.  
  1793. # the video-confirm-frame-delete can have values "yes" or "no"
  1794. # where "no" does not show the confirm dialog windows when the user
  1795. # tries to delete video frames of the video.
  1796. # (default is "yes")
  1797. (video-confirm-frame-delete "yes")
  1798.  
  1799. # optional external audioconverter program
  1800. # must be able to handle the same parameters as the
  1801. # standard converter script audioconvert_to_wav.sh
  1802. # There is NO need for the audioconvert_program gimprc configuration
  1803. # if you use the standard converter script.
  1804. (audioconvert_program "/usr/local/bin/my_private_audioconverter")
  1805.  
  1806.  
  1807. # NON-XCF frame save behaviour:
  1808. # -----------------------------
  1809. # if you want to use GIMP-GAP with other fileformats than XCF
  1810. # for your frames, you will get a warning dialog at the first
  1811. # attempt (per GIMP-session) to save one of the frames with GIMP-GAP plug-ins.
  1812. # If you dont want this warning dialog, you can use the gimprc
  1813. # file to configure how GIMP-GAP should save frames depending on the
  1814. # extension. 
  1815. # for all configured fileformat extensions GIMP-GAP uses the configuration from the
  1816. # gimprc file and does not show the warning dialog.
  1817. # Here are recommanded gimprc configuration settings
  1818. # for some common used fileformats:
  1819.  
  1820. (video-save-flattened-jpg    "yes")
  1821. (video-save-flattened-jpeg   "yes")
  1822. (video-save-flattened-bmp    "yes")
  1823. (video-save-flattened-png    "yes")
  1824. (video-save-flattened-ppm    "yes")
  1825. (video-save-flattened-xjt    "no")
  1826. (video-save-flattened-gif    "no")
  1827.  
  1828.  
  1829. ======================================================
  1830. Internal PDB names and menu names of GIMP-GAP plug-ins
  1831. ======================================================
  1832.  
  1833.   plug_in_bluebox                     "<Image>/Video/Bluebox"
  1834.   plug_in_filter_macro                "<Image>/Filters/Filtermacro"
  1835.   plug_in_gap_anim_crop               "<Image>/Video/Frames Crop"
  1836.   plug_in_gap_anim_resize             "<Image>/Video/Frames Resize"
  1837.   plug_in_gap_anim_scale              "<Image>/Video/Frames Scale"
  1838.   plug_in_gap_del                     "<Image>/Video/Delete Frames"
  1839.   plug_in_gap_density                 "<Image>/Video/Frames Density"
  1840.   plug_in_gap_dup                     "<Image>/Video/Duplicate Frames"
  1841.   plug_in_gap_exchg                   "<Image>/Video/Exchange Frame"
  1842.   plug_in_gap_first                   "<Image>/Video/Goto First"
  1843.   plug_in_gap_goto                    "<Image>/Video/Goto Any"
  1844.   plug_in_gap_last                    "<Image>/Video/Goto Last"
  1845.   plug_in_gap_layers_run_animfilter   "<Image>/Filters/Filter all Layers"
  1846.   plug_in_gap_modify                  "<Image>/Video/Frames Modify"
  1847.   plug_in_gap_move                    "<Image>/Video/Move Path"
  1848.   plug_in_gap_mpeg2encode             "<Image>/Video/Encode/MPEG2 (mpeg2encode)"
  1849.   plug_in_gap_mpeg_encode             "<Image>/Video/Encode/MPEG1 (mpeg_encode)"
  1850.   plug_in_gap_navigator               "<Image>/Video/VCR Navigator"
  1851.   plug_in_gap_next                    "<Image>/Video/Goto Next"
  1852.   plug_in_gap_onionskin_configuration "<Image>/Video/Onionskin/Configuration"
  1853.   plug_in_gap_prev                    "<Image>/Video/Goto Prev"
  1854.   plug_in_gap_range_convert           "<Image>/Video/Frames Convert"
  1855.   plug_in_gap_range_flatten           "<Image>/Video/Frames Flatten"
  1856.   plug_in_gap_range_layer_del         "<Image>/Video/Frames LayerDel"
  1857.   plug_in_gap_range_to_multilayer     "<Image>/Video/Frames to Image"
  1858.   plug_in_gap_renumber                "<Image>/Video/Frames Renumber"
  1859.   plug_in_gap_shift                   "<Image>/Video/Framesequence Shift"
  1860.   plug_in_gap_split                   "<Image>/Video/Split Img to Frames"
  1861.   plug_in_gap_videoframes_player      "<Image>/Video/Playback"
  1862.   plug_in_gap_xanim_decode            "<Image>/Video/Split Video to Frames/Any XANIM readable"
  1863.   plug_in_gap_xanim_decode_toolbox    "<Toolbox>/Xtns/Split Video to Frames/Any XANIM readable"
  1864.  
  1865.   script-fu-selection-to-anim-image   "<Image>->Script-Fu->Animators->Sel To AnimImage"
  1866.  
  1867.   plug_in_gap_get_animinfo            ** NON_INTERACTIVE batchscript API
  1868.   plug_in_gap_move_path_ext           ** NON_INTERACTIVE batchscript API
  1869.   plug_in_gap_move_path_ext2          ** NON_INTERACTIVE batchscript API using a controlpoint file
  1870.   plug_in_gap_set_framerate           ** NON_INTERACTIVE batchscript API
  1871.   plug_in_gap_video_edit_clear        ** NON_INTERACTIVE batchscript API
  1872.   plug_in_gap_video_edit_copy         ** NON_INTERACTIVE batchscript API
  1873.   plug_in_gap_video_edit_paste        ** NON_INTERACTIVE batchscript API
  1874.